home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / README < prev   
Encoding:
Text File  |  1994-08-02  |  14.6 KB  |  286 lines
  1.  
  2.  
  3.                         README for documents subtree
  4.  
  5.  
  6.          This is a subtree of documents containing various technical 
  7.                information about SGI's software and hardware.
  8.  
  9.          `!' indicates new or updated as of version 4.2
  10.  
  11.  
  12.  
  13.        64bit   :  information relating to 64bit machines SGI is working 
  14.                   on:  "Preparing for the 64 bit Future of IRIX", "Native 
  15.                   64-bit Subprogram Interface for MIPS Architectures", 
  16.                   "64-bit C Porting Guide", and a C & Fortran variable 
  17.                   sizes file.
  18.  
  19.  
  20.        ANSI-C  :  contains files comprising a technical review of the book,
  21.                   "The Annotated ANSI C Standard", and the text originally 
  22.                   published as the ANSI C rationale with useful information
  23.                   about the origin, creation and meaning of the ISO C 
  24.                   standard.
  25.  
  26.  
  27.        audio   :  a PostScript file version of the 8/26/91 Draft Document 
  28.                   by Apple Computer discussing "Audio Interchange File 
  29.                   Format AIFF-C, A revision to include compressed audio 
  30.                   data"
  31.  
  32.  
  33.        cc_c++_make_csh:  collection of documents relating to compilers, 
  34.                   [p]make, and c-shell:
  35.  !             * DeltaC++.ps:  "The Silicon Graphics Delta C++ Compiler" 
  36.                   White Paper, (Preliminary), 18 pages.  new 
  37.                   C++ compiler supports C++ shared library 
  38.                   evolution and speeds up the build process.
  39.                   * c++-rules.ps: "Programming in C++, Rules and 
  40.                                   Recommendations", (C) 1990-1992 by Ellemtel 
  41.                                   Telecommunications Systems Laboratories, 
  42.                                   88 pages.
  43.                   * commonrules.ps:  "Silicon Graphics Inc, Common Makefile 
  44.                                   include files, Notes", 5/6/93, 39 pages.
  45.                   * cpp.qr        123-line C pre-processor "cheat sheet" 
  46.                                   quick ref.
  47.                   * csh.qr        123-line C-shell quick reference.
  48.                   * make.qr       95-line make quick reference.
  49.                   * pmake.qr      203-line pmake quick reference guide.
  50.                   * makeconv.ps   "Silicon Graphics Makefile Conventions", A
  51.                                   Reference manual of the conventions 
  52.                                   followed in SGI Makefiles, 10/8/91, 37 pages.
  53.  
  54.  
  55.        DevDriver: contains inst-able images of two SGI manuals:  the "IRIX 
  56.           Device Driver Programming Guide" and the "IRIX Device 
  57.           Driver Reference Pages."  These manuals explain how to 
  58.           write device drivers for IRIX Releases 5.0 and later and 
  59.           can be viewed using InSight.  For installation 
  60.           instructions, see the README file.
  61.  
  62.  
  63.  !     Dwarf:     updated doc on DWARF, a binary debugging-information format.
  64.           The IRIX 6 compilers will produce debugging information in 
  65.           this format rather than the format used in 5.2 and earlier 
  66.           releases.
  67.                   Only people *writing* compilers, debuggers, or related tools
  68.                   are affected directly by this change.
  69.                   DWARF defines, in detail, a way for compilers to 
  70.                   tell debuggers about source programs.  DWARF1 is the DWARF 
  71.                   produced by USL's SVR4 compilers and used by their 
  72.                   debuggers.  It is no more capable than the MIPS mdebug 
  73.                   symbol table and is less dense than mdebug.  We will not 
  74.                   use DWARF1.  SGI will be using DWARF 2.  It is capable of 
  75.                   recording much more detailed information than DWARF 1 and 
  76.                   is far more compact (debugging information in DWARF2 
  77.                   format takes much less space on disk than debugging 
  78.                   information in DWARF1 format).
  79.  
  80.  
  81.        GIO_DRVR:  contains a PostScript file with information needed to
  82.                   write a device driver for a GIO board with sections 
  83.                   addressing:  Determining GIO Device Addresses, 
  84.                   Including GIO Device Drivers in the Kernel, Writing 
  85.                   edtinit(), GIO-Specific System Calls, GIO Interrupt 
  86.                   Handler, Programmed I/O (PIO), DMA Operations, GIO 
  87.                   Devices with Hardware Supported Scatter-Gather 
  88.                   Capability, and DMA on GIO Devices with No Scatter-
  89.                   Gather Capability.
  90.  
  91.  
  92.        I18N:      contains documentation on SGI's implementation of
  93.                   software Internationalization.  Although these are only
  94.                   draft versions, they are included for those wishing to 
  95.                   get ahead.
  96.  
  97.  
  98.        irix5.2plusNewProds:  info relevant to irix 5.2 and New Products:
  99.  !                * colormap usage differences between 5.1* and 5.2
  100.  !                * "HIPPI Performance on IRIX 5.2" white paper,
  101.                   * 2 files on HIPPI:  New Product Bulletin + QnA's,
  102.               * question-and-answer on the Indigo Magic User Environment 
  103.             Interface, 
  104.  !                * html document on InPerson desktop conferencing sw product.
  105.               * the major changes between the 4.X and 5.2 versions of the
  106.             Installation Guide, 
  107.               * IRIS Media Libraries New Product Information on 
  108.             dmedia_dev and svideodev,
  109.                   * Periodic Table IRIX Operating Systems as a 3-page 
  110.             showcase file--current as of APRIL 13, 1994,
  111.  !                * "REACT in IRIX V.5 Technical Report" paper on real-time
  112.             IRIX 5 capabilities on Onyx and CHALLENGE MP systems,
  113.  !                * list of 5.2 IRIX patches, info current as of 7/20/94,
  114.                   * Software Compatibility Matrix for software product 
  115.             numbers and software releases from 4.0.1 to 5.2, 19 pages
  116.               * Field Information Bulletin #414 documenting known bug:  
  117.             "Indigo2 XZ/Extreme stipple register causes graphics 
  118.             problems on IRIX 5.2",
  119.                   * guidelines for the use of the /usr/share filesystem.
  120.  
  121.  
  122.        Inventor:  contains documentation/information on Inventor including:
  123.                   * "How to Write an Open Inventor File Translator" PS file,
  124.               * updated "Quick Reference Guide" PS file with information 
  125.             on Open Inventor nodes and the Inventor file format, 
  126.                   * 38-page showcase document on the Open Inventor 3D Toolkit.
  127.           plus the man page for the DxfToIv utility which converts 
  128.           AutoCad's DXF format files to Inventor files (the binary, 
  129.           DxfToIv is located in toolbox/src/exampleCode/inventor).
  130.  
  131.  !                see the new toolbox/src/exampleCode/inventor/www FAQ + 
  132.           Known Bugs, Fixes, and Workarounds html information files 
  133.           copied from the Silicon Surf www.sgi.com site.  access this 
  134.           thru toolbox/www/toolbox.html (consult toolbox/www/README)
  135.  
  136.  
  137.        libconv :  the newest addition to the mathlib subtree, libconv is 
  138.                   an optimized library available on Silicon Graphics 
  139.                   computers.  It features Convolution for Finite Impulse 
  140.                   Response (FIR) and Infinite Impulse Response (IIR) 
  141.                   filters, together with Correlations.  The library 
  142.                   modules take 1D and 2D inputs, and are available in 
  143.                   single and double precision for real and complex 
  144.                   arithmetic.  The 2D subprograms have been parallelized 
  145.                   and take full advantage of SGI parallel architecture.
  146.  
  147.  
  148.        mipsABI :  contains doc for mipsABI porting materials includes PS 
  149.                   copy of the "MIPS Processor ABI Conformance Guide Version 
  150.                   1.1.1" (the "Black Book"), a mips FAQ about porting to 
  151.                   the ABI, and a short paper entitled "Constructing MIPS 
  152.                   ABI Compliant Binaries on the IRIX 5.x Operating System".
  153.  
  154.  !                see the new toolbox/src/swtools/mipsABI/abi-html MIPS ABI 
  155.           Information Directory in html format replete with hyperlinks,
  156.           in-line images, etc, including a FAQ on porting to the MIPS 
  157.           ABI.  access this thru toolbox/www/toolbox.html (consult 
  158.           toolbox/www/README)
  159.  
  160.        Motif   :  contains a copy of an SGI internal paper on Motif
  161.                   Performance Notes.
  162.  
  163.  
  164.        OpenGL  :  new additions include:  
  165.  !                * opengl.ps:  "The Design of the OpenGL Graphics Interface"
  166.                   Also contains, "OpenGL and X" PostScript and showcase files 
  167.           of the tutorial presented at the 8th Annual X Technical 
  168.           Conference, Boston, Mass., 1/24/94, 2 versions of a list 
  169.           mapping Iris GL commands to similar OpenGL ones, an Analysis 
  170.           of PEX 5.1 and OpenGL 1.0, "OpenGL and X, Part 1:  An 
  171.           Introduction", "OpenGL and X, Part 2:  Using OpenGL with 
  172.           Xlib," "OpenGL(tm) and X, Part 3: Integrating OpenGL with 
  173.           Motif" from "The X Journal", "X Server Multi-rendering for 
  174.           OpenGL and PEX", and 3 PostScript files for the OpenGL 
  175.           Specification, including the Spec itself, the OpenGL Utility
  176.           Library, and the API for the OpenGL extension to the X 
  177.           Window System.
  178.           
  179.  
  180.        networking:  networking documentation including:
  181.  !                "Establishing a PPP connection using IRIX PPP" paper,
  182.  !                "SLIP INSTALLATION AND CONFIGURATION GUIDE",
  183.  !                "Asynchronous Transfer Mode:  Implementations for 1994"
  184.  
  185.  
  186.        optimization:  dir contains PostScript copy of how to optimize your 
  187.           code from chapters one and three of the "Irix Programming 
  188.           Guide," covering "Using the Compiler System," and 
  189.           "Improving Program Performance," as well Chapter Two of the 
  190.           "IRIX System Programming Guide," to help you use and build 
  191.                   Dynamic Shared Objects.  Also included are overview
  192.                   descriptions of Build-time alternatives relating to ld, and
  193.                   an overview of Quickstart, Requickstart and tasks performed
  194.                   by RLD, the dynamic linker.
  195.  
  196.  
  197.        RFC     :  Internet Request For Comments (RFCs) are texts documenting
  198.                   problems, test results, protocols, jokes, and just about
  199.                   every aspect of the Internet, since its inception.  
  200.                   Starting with rfc3.txt this collection details a technical
  201.                   (and to some extent political) history of what has become 
  202.                   a global communication infrastructure, currently present 
  203.                   in over thirty countries in all continents.
  204.  
  205.                   Internet "Request For Comments" provide the current set 
  206.                   of open standards used on the Internet, today.  To both 
  207.                   ensure interoperability with other products and prevent 
  208.                   re-invention of wheels, developers of network apps will 
  209.                   find it useful to be familiar with, and to the extent 
  210.                   possible conform to, applicable standards.  Examples of 
  211.                   available standards are the Simple Network Monitoring 
  212.                   Protocol (SNMP), Internet Protocol (IP), File Transfer 
  213.                   Protocol (FTP), and Simple Message Transfer Protocol 
  214.                   (SMTP), all of which are supported by SGI.  Thus, if you 
  215.                   were to write a network management tool, since numerous 
  216.                   network devices use SNMP, you could manage each one by 
  217.                   reading about its interface to SNMP, which is likely 
  218.                   documented in an RFC.
  219.  
  220.  !                new rfc files:  fyi1.txt, fyi2.txt, rfc1291.ps, 
  221.                   rfc129[5-7].txt, rfc1521.ps, rfc1563.ps, 
  222.                   rfc1583.ps, rfc1584.ps,
  223.                   rfc[1540-1649,1651-1663].txt
  224.  
  225.  !                WARNING:  this dir now measures 63+ megabytes.  See 
  226.                             RFC/{README,rfc-index.txt} for more details.
  227.  
  228.  
  229.        SiliconStudio:  information about Silicon Studio, a professional film 
  230.                   and video production system based on Silicon Graphics 
  231.                   workstations, specialized video options and third-party 
  232.                   software solutions:
  233.                   * "Creative Desitinations, Silicon Studio Training Centers"
  234.                     locations document, 
  235.                   * "Silicon Studio Technical Report" covering video and 
  236.             compression products including Gailieo Video, 
  237.             Indy/Indigo^2 Video, Cosmo Compress, and Sirius Video,
  238.                   * "The Silicon Studio for Publishing Environment from 
  239.             Silicon Graphics".
  240.  
  241.  
  242.        textureMapping:  addresses issues pertaining to texture mapping:
  243.  !            * "Fast Shadows and Lighting Effects Using Texture Mapping"
  244.  !            * "Texture Mapping as a Fundamental Drawing Primitive"
  245.                   * "Interactive Geometric Image Transformation Using 
  246.             Texture Mapping" paper,
  247.                   * "Accelerated Volume Rendering and Tomographic 
  248.                     Reconstruction Using Texture Mapping Hardware",
  249.                   * "Texture Mapping in Technical, Scientific and 
  250.             Engineering Visualization".
  251.  
  252.        VMEinterface:  VME interface description for Personal Iris, 4D100
  253.                   to 4D400 series machines, and Crimsons.  This paper
  254.                   does NOT include the IO4 VME in Challenge and Onyx 
  255.                   systems.
  256.  
  257.  
  258.        video   :  contains the SGI Digital Video specification including 
  259.                   the data format, electrical and mechanical interfaces 
  260.                   used to get digital video data into and out of the 
  261.                   Silicon Graphics platforms via this 60-pin connector.
  262.  
  263.  
  264.        XInputExtension:  contains four PostScript files on the X11R5 Input 
  265.                   Extension Library written by the MIT X Consortium:  "X11 
  266.                   Input Extension Library Specification", "X11 Input 
  267.                   Extension Porting Document", "Appendix A,  Input Extension 
  268.                   Protocol Encoding", and "X11 Input Extension Protocol 
  269.                   Specification", as well as a copy of the README file that
  270.                   will appear under /usr/lib/X11/input/config later in 1994,
  271.                   providing info on Device controls and the ways SGI has 
  272.                   extended them to change and query things about devices.
  273.  
  274.  
  275.        Xpm     :  a document on XPM (X PixMap), a format for storing/
  276.                   retrieving X pixmaps to/from files.
  277.  
  278.  
  279.        Xserver :  newest addition is "X Server Multi-rendering for OpenGL and
  280.                   PEX", presented at the 8th Annual X Technical Conference, 
  281.                   Boston, Mass., 1/25/94.  also contains 3 PostScript 
  282.                   versions of Silicon Graphics X server papers respectively 
  283.                   titled, "A Fully Functional Implementation of Layered 
  284.                   Windows," "Program X Overlay Windows," and "Going Beyond the 
  285.                   MIT Sample Server:  The Silicon Graphics X11 Server".
  286.